home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / telecomm / btst240l.lzh / README.ST < prev    next >
Text File  |  1990-09-11  |  16KB  |  372 lines
  1. Atari ST version of BinkleyTerm 2.40
  2. ------------------------------------
  3.  
  4. Version 2.40d, 11th September 1990
  5. ---------------------------------
  6.  
  7. This document describes the differences between the Atari ST version
  8. and the PC version of BinkleyTerm 2.40.  I recommend that you print
  9. out completely the complete manuals before attempting to install it.
  10.  
  11. You should have:
  12.   BT_USER.DOC : BinkleyTerm 2.30 User's guide (62 pages)
  13.    BT_REF.DOC : BinkleyTerm 2.30 Referene Guide (46 pages)
  14.  BINK_240.DOC : BinkleyTerm 2.40 Addendum (unformatted 11 pages)
  15.    README.ST  : BinkleyTerm 2.40 AtariST addendum (This document)
  16.   LICENSE.240 : BinkleyTerm 2.40 license
  17.  COMPRESS.TXT : Additional licensing rules concerning re-archiving.
  18.  
  19. This archive should also contain
  20.   BT.TTP      : The main BinkleyTerm-ST program
  21.   BTCTL.TOS   : Produces MAIL.SYS and BINKLEY.PRM which are used by other 
  22.                 programs such as oMMM.
  23.   BTLNG.TOS   : Compiles a message file
  24.   BINKLEY.LNG : The compiled English language file
  25.   ENGLISH.TXT : The raw English language file
  26.  
  27. There may also be some example configuration and event files.
  28.   BINKLEY.CFG : Example configuration file
  29.   BINKLEY.EVT : Example event file
  30.    SAMPLE.TLP : Example Response file template
  31.  
  32. Introduction
  33. ------------
  34.  
  35. The AtariST version works basically as described for the PC apart from
  36.  - Only one comms port is supported.  I don't have any information on using 
  37.    external ports.
  38.  - The highest supported baud rate is 19200 baud.  That is as high as the 
  39.    ST will go.
  40.  - There is no support for multitasking.
  41.  
  42. To make use of BinkleyTerm-ST, you will also need the programs:
  43.   oMMM   (For processing and routing outbound messages)
  44.   CM     (ConfMail for processing EchoMail)
  45.   ParselST (Nodelist processor)
  46. and if you are running FoReM or ///Turbo-ST, you are advised to use:
  47.   FidoDoor (An external program to access the FidoNet messages)
  48.   FiFo     (Lets you use the FoReM///Turbo message bases for FidoNet)
  49. Other useful programs include:
  50.   MsgEd (a local message editor)
  51.   Renum (renumbers fidonet messages)
  52.   WhatArc (lets you use ArcMail, ZipMail and LzhMail files instead of the 
  53.           default ARCmail)
  54.   CMfix (Fixes up problems caused by a bug in the ST port of CM)
  55. FidoDoor is shareware, all the others are freeware.  They should all be 
  56. readily available from a BBS near you.  Probably the same place as you got 
  57. this.
  58.  
  59.  
  60. Quick installation for users of older (1.03) versions
  61. -----------------------------------------------------
  62.  
  63. Copy the files BT.TTP, BTCTL.TOS and BINKLEY.LNG into your binkley
  64. directory.
  65.  
  66. Edit Binkley.cfg:
  67.  - Comment out or delete the "Colors" line (if any) or set it to one of the 
  68.    recommended color sets elsewhere in this document.
  69.  - Comment out or delete the "Command" and "Timezone" lines.
  70.  
  71. Run the new BTCTL.TOS
  72. Run BT.TTP
  73.  
  74. Everything should now be working roughly as before.  You may want to read 
  75. all the manuals and make further modifications to the configuration file as 
  76. required.  As a bare minimum you should read this document thoroughly, in 
  77. particular the section about differences between this and older versions.
  78.  
  79.  
  80. Environment variables
  81. ---------------------
  82.  
  83. Setting these depends on what shell you use, if you are using Pcommand then 
  84. you would use:
  85.   set NAME=value
  86.  
  87. COMSPEC:
  88.    should be the name of an external shell such as PCOMMAND.PRG unless you 
  89.    are using a shell that uses the _shellp system variable (e.g. Gulam or 
  90.    Craft).
  91. SHELL:
  92.    is similar to COMSPEC.  Only one of these needs to be defined.  Actually 
  93.    there is a difference in that COMSPEC is the name of a shell program 
  94.    called when you press Escape, whereas SHELL is a shell used when 
  95.    executing an external program or batch file.  If you don't understand 
  96.    any of this then you are best off just setting COMSPEC.
  97. BINKLEY:
  98.    is the name of the main directory where BT expects to find its 
  99.    configuration files.
  100. TBUF:
  101.    is the size of the Transmitter buffer.  If undefined it will default to 
  102.    8192 bytes.  You may need to fiddle with this to get Janus working 
  103.    properly (refer to the Janus section in the 2.40 addendum).
  104. RBUF:
  105.    is the size of the receive buffer and defaults to 8192 bytes.  You may 
  106.    need to fiddle with this to get Janus working.
  107. TZ:
  108.    is the timezone information.  Format is:
  109.        set TZ=aaabbbccc
  110.    aaa is a 3 letter abreviation for local time, e.g. CET or GMT.
  111.    bbb is a number between -23 and +24 indicating the value that is 
  112.        subtracted from GMT to obtain local standard time.
  113.    ccc is optional and is an abbreviation for local daylight savings, 
  114.        e.g. BST.
  115.    If not present then Greenwich meantime is assumed.  If you keep your 
  116.    system clock at local time then you shouldn't need to be bothered with 
  117.    this.
  118.  
  119. Most users won't need to bother with most of these except for BINKLEY and 
  120. COMSPEC.
  121.  
  122.      
  123. Keyboard
  124. --------
  125.  
  126. Because of the difference between the ST keyboard and the PC there are a 
  127. few small differences.
  128.   The [Help] key does the same as Alt-F10 on the PC (in addition to Alt-F10 
  129.   still working).  It brings up a brief help screen.
  130.  
  131.   The [Undo] Key toggles between terminal mode and unattended mode (in 
  132.   addition to whatever the PC keys are).  This is to provide compatibility 
  133.   with the older ST versions.
  134.  
  135.   Shift-Down_Arrow is the same as the page down key on the PC and starts a 
  136.   download when in Terminal mode.  Older versions of BT-ST used to use the 
  137.   Clr/Home key.
  138.  
  139.   Shift-Up_Arrow is the same as page up and starts an upload.  Older 
  140.   versions of BT-ST used to use the Insert key.
  141.  
  142. If you press a key and nothing happens then just wait a few seconds because 
  143. it will still be in the keyboard buffer waiting for Binkley to get around 
  144. to processing it.  I had a lot of trouble with losing characters, but I 
  145. think it is solved now.
  146.  
  147.  
  148. Video
  149. -----
  150.  
  151. The COLORS configuration line works as described in the reference manual.  
  152. Each parameter is a colour calculated as:
  153.   background*16+foreground
  154. where the colours are the logical colours used by Tos.  e.g. on a hi-rez 
  155. screen they are 0 or 1, on a medium rez 0,1,2,3, etc.  Be very careful not 
  156. to make the background the same as the foreground.  Refer to the reference 
  157. guide for what each parameter does.  The actual colours will depend on what 
  158. you set them to with the desktop control accessory.  You'll probably be 
  159. best off simply using Black and White!!!  Tos only uses the low bits needed 
  160. by that resolution so you can specify a colour as colour 15, but on a mono 
  161. screen this will be the same as 1.  I hope all that makes sense to you.
  162. Some recommended colors are:
  163.  Colors 1 3 2 3 3 2 48 32   ; (Medium rez)
  164. or
  165.  Colors 7 7 7 7 7 7 240 240 ; (Mono/Hirez)
  166. The default is something like I just recommended for monochrome.
  167.  
  168. The screen will adjust itself to the physical screen size when intialised.  
  169. Thus if you are using that program that lets you have 50 rows on a 
  170. mono-screen (instead of the usual 25), BinkleyTerm will use the entire 
  171. screen.
  172.  
  173. Line A variables are used to move the cursor about and change colours, 
  174. which makes it quite a bit faster than sending all this through the VT52 
  175. emulator.
  176.  
  177.  
  178. RS232
  179. -----
  180.  
  181. You must use CTSFIX if you are using Tos 1.4 or TURBOCTS on older versions 
  182. of TOS.  These correct errors concerned with RTS/CTS flow control.  These 
  183. programs should be readily available from most BBS's.  CTSFIX is one of 
  184. Atari's official TOS 1.4 bug fixes.  If you don't use these then you will 
  185. find that the comms port will lock up!  They are both normally put in the 
  186. AUTO directory.
  187.  
  188. The buffer sizes are configurable using the TBUF and RBUF environment 
  189. variables described in the environment variables section.  Binkley does 
  190. quite a lot of low level work with the MFP and the BIOS's buffers to get 
  191. things working efficiently.
  192.  
  193.  
  194. Time
  195. ----
  196.  
  197. You must ensure that the time and date on the ST are set correctly.  This 
  198. can be achieved either through the use of a real-time clock or by using a 
  199. utility such as Nelli